home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / latex209 / contrib / biblist / README < prev   
Text File  |  1992-01-14  |  3KB  |  87 lines
  1. % $Id: biblist.README,v 1.2 1992/01/13 16:43:03 schrod Exp schrod $
  2. %------------------------------------------------------------
  3.  
  4. There is an often asked question: `How can I print a listing with all
  5. entries of a BibTeX database?'. The common answer is: `Use
  6. \nocite{*}.'
  7.  
  8. Well, but this will not work for large BibTeX databases unless you
  9. use BigTeX. This is because for each entry a TeX macro is declared
  10. and TeX's pool size capacity (where macro names are stored) will be
  11. exceeded soon.
  12.  
  13.     
  14. This style option is appropriate to create a typeset listing of a
  15. (possibly large) BibTeX input file. With such large files --
  16. especially, if the cite keys are long -- the needed string space is
  17. often exceeded. Often a BigTeX is available to circumstance this
  18. problem, but with this style option each TeX will do it.
  19.  
  20. You have to prepare a LaTeX document which uses the |article|
  21. style and the biblist style option. You may add almost all other
  22. style options, as you wish, e.g., twoside, german (or other
  23. language style options), a4, etc. This style option must be used
  24. with a ragged bottom; this has the effect, that it cannot be used with
  25. twocolumn or multicol.
  26.  
  27. You must issue a \bibliography tag which names all BibTeX
  28. databases which you want to print. You may issue a
  29. \bibliographystyle tag to specify how BibTeX will process its
  30. databases. (In fact, you usually must issue it since the default
  31. bibliography style is not available on most installations; see
  32. below.) You may issue \nocite commands if you want to print only
  33. selected entries from the databases.
  34.  
  35.  
  36. A ``bug'' you may encounter is that \cite tags within
  37. BibTeX entries will not be processed. Instead the cite key itself
  38. will be printed. Note that this is not a bug, this is a feature! You
  39. have to use \nocite tags for *all* entries that shall be
  40. included in the listing. If you do not give any \nocite tag at all,
  41. a listing with all entries is created.
  42.  
  43. Note that this style option assumes that you use either LaTeX~2.09
  44. released after December 1991, ILaTeX, or the babel system.
  45. Particulary, it requires the definition of \refname which is supplied
  46. by these systems. (Of course, you may supply this definition by
  47. yourself.)
  48.  
  49.  
  50. The entries in the resulting listing are formatted as follows:
  51.  
  52. \tt cite key ................................... \sf (Library info)
  53.     Author(s).
  54. Title.
  55. Publication info.
  56. Notes.
  57.     \footnotesize Annotation
  58.  
  59. I.e., an open format is used. Although this needs more space I think
  60. the enhanced legibility pays back.
  61.  
  62. Note that you will not get the `Library info' and the `Annotation' in
  63. the above format if your bibliography style does not supply this
  64. information with the assumed markup. The parenthesis around the library
  65. info are produced by this style option, not by BibTeX.
  66.  
  67.  
  68. Enjoy. btw, this style is supported since I use it myself :-)
  69.  
  70. --
  71. Joachim
  72.  
  73. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  74. Joachim Schrod            Email: schrod@iti.informatik.th-darmstadt.de
  75. Computer Science Department
  76. Technical University of Darmstadt, Germany
  77.  
  78.  
  79. $Log: biblist.README,v $
  80. Revision 1.2  1992/01/13  16:43:03  schrod
  81.    Updated documentation, adapted to LaTeX version of Dec 91.
  82.    New biblist.bst-dist (itibst.doc version 1.3).
  83.  
  84. Revision 1.1  1991/10/14  13:54:15  schrod
  85. Initial revision
  86.  
  87.